home *** CD-ROM | disk | FTP | other *** search
/ Games of Daze / Infomagic - Games of Daze (Summer 1995) (Disc 1 of 2).iso / intercd.doc < prev    next >
Text File  |  1995-06-17  |  14KB  |  322 lines
  1. Jouni Miettunen * jon@stekt.oulu.fi * Oulu * Finland * Europe * 1995
  2. INTERCD(1)                USER COMMANDS                   INTERCD(1)
  3.  
  4.  
  5.                Ask, and it shall be given you;
  6.                seek, and ye shall find;
  7.                knock, and it shall be opened unto you.
  8.  
  9.                               The Bible, Matthew 7:7
  10.                               (King James version)
  11.  
  12.  
  13. ** CONTENTS
  14.  
  15.    NAME                     KEYBOARD SHORTCUTS       BUGS
  16.    OPTIONS                  TEXT EDITING             AUTHOR
  17.    EXAMPLES                 ERROR CODES              SEE ALSO
  18.    USER INTERFACE           DEVELOPMENT              STATUS
  19.    SEARCH ENGINE            HISTORY
  20.  
  21. ** NAME
  22.  
  23.      intercd
  24.  
  25.      A graphical user interface program for CD-ROM disks. This version
  26.      especially written for InfoMagic to be used with their excellent
  27.      CD-ROM containing the x2ftp.oulu.fi game programming archives.
  28.  
  29.      You need an IBM compatible computer with 8086 compatible CPU
  30.      (prosessor), a standard VGA compatible video card and monitor
  31.      (640x480x16 resolution) and CD-ROM disk drive with MSCDEX 2.0
  32.      compatible driver. A mouse is supported, but not required.     
  33.  
  34. ** OPTIONS
  35.  
  36.      intercd < CD-ROM disk drive < target disk > >
  37.  
  38.      CD-ROM disk drive
  39.           The CD-ROM disk drive you want to use
  40.  
  41.      target disk
  42.           The disk drive where you want to copy files from CD-ROM
  43.  
  44. ** EXAMPLES
  45.  
  46.      intercd
  47.           If no command-line parameters are given, the first found
  48.           CD-ROM disk drive will be selected as CD-ROM drive and the
  49.           current disk as the target disk drive.
  50.  
  51.      intercd e:
  52.           Disk drive E: is selected as the CD-ROM drive and current
  53.           disk drive as the target disk. The drive E: has to be a
  54.           CD-ROM disk drive and have a disk inside and available.
  55.  
  56.      intercd e: c:
  57.           Disk drive E: is selected as the CD-ROM disk drive and C: as
  58.           the target disk drive. Both have to exists and be usable.
  59.  
  60. ** USER INTERFACE
  61.  
  62.      InterCD has a Graphical User Interface to make using the CD-ROM
  63.      disk easy. All necessary status information is presented on-screen
  64.      and user operations are available via both mouse and keyboard.
  65.  
  66.      At the top of the screen is the name and version of the program.
  67.  
  68.      At the second line is the CD-ROM disk drive letter and full path of
  69.      the currently selected directory on it. This line will always tell
  70.      you where you are wandering in the depths of the CD-ROM disk.
  71.  
  72.      In the middle of the screen there are two windows presenting file
  73.      listings of two different disk drives. At the left is your CD-ROM
  74.      disk drive, at the right side is some other disk (by default the
  75.      startup disk). The left window is called Source and the right as
  76.      Target. The Target disk drive letter and current directory on it is
  77.      shown just above the Target window.
  78.  
  79.      Each window presents an alphabetic directory listing of the current
  80.      directory so that directories are shown first in uppercase followed
  81.      by normal files in lowercase. The line highlighted by red is the
  82.      current selection in that directory. The selection can be changed
  83.      either by mouse or by cursor keys. At the right edge of the window
  84.      is a scrollbar that can be used to view lines currently not visible.
  85.      Please note that also PageUp, PageDown, Home and End keys can be
  86.      used to view the full directory listing.
  87.  
  88.      Only one of the windows is active at a time. You can identify the
  89.      selected window with the line just between the Source and Target
  90.      windows (see below) or by the highlighted line in the directory
  91.      listing. You can change the windows either by pressing TAB key or
  92.      clicking inside the window with the mouse.
  93.  
  94.           >> Copy   Source window is selected (you can copy files)
  95.           Copy >>   Target window is selected (you cannot copy files)
  96.  
  97.      Between Source and Target windows there are three buttons that can
  98.      be used to copy files from Source to Target ie. from the CD-ROM to
  99.      your own disk. You cannot copy files from Target to Source.
  100.  
  101.      Selecting the first button "Copy" copies just the highlighted item, 
  102.      either one file or a directory with everything under it, the second
  103.      button "Files" copies all files in the current Source directory and
  104.      the last button "All" everything, also including subdirectories.
  105.  
  106.      If the Source file or directory already exists on the Target disk,
  107.      you will be asked whether you wish to overwrite it. If the Source
  108.      is a directory, you can choose between Yes/No/All/Cancel choises.
  109.      If you select All and are copying a directory, the directory with
  110.      all subdirectories is first removed from the Target disk. Beware!
  111.  
  112.      Under the Target window there are 4 buttons supporting the basic
  113.      file management operations. With "Disk drive" you can change the
  114.      target disk, with "Make directory" you can create new directories
  115.      on the target disk, with "New name" you can rename both files and
  116.      directories and with "Remove" you can remove either directories or
  117.      files. Please note that directories with subdirectories really are
  118.      removed. Make sure you know what you're doing!
  119.  
  120.      Under the Source and Target windows there is the Search Engine. For
  121.      more information please read the SEARCH ENGINE later in this manual.
  122.  
  123.      At the bottom of the screen there are four buttons providing some
  124.      basic operations:
  125.  
  126.      Info
  127.           will tell you about this program. Press any key to continue.
  128.      View
  129.           can be used to view ascii text files (current selection). You
  130.           can use either mouse or arrow keys to scroll the text. The
  131.           PageUp, PageDown, Home and End keys can also be used.
  132.      Shell
  133.           enables you to make a shell escape into DOS. Type exit at DOS
  134.           command line to return to InterCD. Please note that during shell
  135.           escape you still are using InterCD and must return and exit
  136.           normally to quit InterCD.
  137.      Exit
  138.           exit InterCD. The one and only way to stop using this program.
  139.  
  140. ** SEARCH ENGINE
  141.  
  142.      Search engine can be found under the Source and Target windows and
  143.      above the four buttons at the botton of the screen. There are four
  144.      parts and following is a description how to use them:
  145.  
  146.      1) Click once with mouse on the Search String area (by default it
  147.      has text "Enter search string"). If you do not have mouse, press
  148.      key "L" to select the "Locate" button.
  149.      You are presented a dialog, where you can edit the current text
  150.      string used in the Search operation. Press ENTER once you're done.
  151.  
  152.      2) Select "Locate" button to start the search. The search is case
  153.      insensitive, based on the information found in 00index.txt files and
  154.      done only on the current CD-ROM disk directory and all subdirectories.
  155.      You might want to change into the root of the CD-ROM disk beforehands.
  156.  
  157.      3) When a 00index.txt line containing your search string is found, the
  158.      current directory on the CD-ROM disk drive is changed into appropriate
  159.      subdirectory and the found item is highlighted in the file listing.
  160.      Also the full 00index.txt line is presented under the Search String
  161.      area.
  162.  
  163.      4) Next you can do anything: you can view texts, copy files, change
  164.      directories or run programs. When you wish to continue the search you
  165.      only have to select the "Go next" button and the search will continue
  166.      in the place and directory, where it ended last time.
  167.      Once everything is checked and nothing more found, you are returned
  168.      into the startup directory. You can start a new search anytime by
  169.      selecting "Locate" button or by writing a new search string.
  170.  
  171. ** KEYBOARD SHORTCUTS
  172.  
  173.      F1
  174.           Short online help for the basic keyboard shortcuts.
  175.  
  176.      ESC
  177.           Exit InterCD. You will be presented a dialog to verify, if you
  178.           really want to exit. Select "Yes" button to quit, "No" button
  179.           to continue.
  180.  
  181.      TAB
  182.           Change the active window ie. Source <-> Target window. You can
  183.           identify the current active window either with the highlighting
  184.           in the file listing or with the ">> copy" text between the two
  185.           windows: "greater than" characters are closer to the active one.
  186.  
  187.      Backspace
  188.           Change into the parent directory of the current directory.
  189.  
  190.      \
  191.           Change into root of the current disk.
  192.  
  193.      RETURN
  194.      ENTER
  195.           Change directory, run an executable or view an ASCII text
  196.           file.
  197.  
  198.      Buttons
  199.           Each button has a title, where the first character is in
  200.           different color. By selecting this key on the keyboard you
  201.           can select the button and its operation.
  202.  
  203.      Arrow keys
  204.           With arrow keys you can change the currently selected item
  205.           in the file listings of the Source and Target windows. 
  206.  
  207.      Home
  208.           You select the first item in file listing.
  209.  
  210.      End
  211.           You select the last item in file listing.
  212.  
  213.      PageUp
  214.           You scroll up the file listing by one screenful.
  215.  
  216.      PageDown
  217.           You scroll down the file listing by one screenful.
  218.  
  219. ** TEXT EDITING
  220.  
  221.      In several places you are presented with a dialog, where you can
  222.      enter text. In all cases you can type text one character at a time
  223.      in either insert (default) or overwrite mode. The mode is toggled
  224.      with the Insert key and can be identified with the cursor: insert
  225.      cursor is a vertical line and any new character will be entered
  226.      between the characters left and right of it. The overwrite cursor
  227.      is a box and a new character will replace the character inside it.
  228.  
  229.      With arrow keys you can change the current text enter place one
  230.      character at a time. With Home you can go directory to the head
  231.      and with End to the end of the current text string.
  232.  
  233.      Backspace deletes a character to the left of the cursor, delete
  234.      to the right of the cursor. ESC will remove all the characters.
  235.      Control-Home will remove everything to left of the cursor and
  236.      control-End everything to right of the cursor.
  237.  
  238.      Some emacs commands related to the operations described above are
  239.      supported.
  240.  
  241. ** ERROR CODES
  242.  
  243.      0    More or less controlled and desired exit. Do not remove the
  244.           CD-ROM disk from your CD-ROM disk drive while using InterCD.
  245.      1    Usage info shown, because there was too many command-line
  246.           arguments or it was especially requested (-?)
  247.      2    Could not find any CD-ROM disk drives. Either you don't have
  248.           MSCDEX driver loaded or any CD-ROM disk drives connected.
  249.      3    You have the required MSCDEX driver and one (or more) CD-ROM
  250.           disk drive online, but the MSCDEX is too old. Please update it.
  251.      4    You have specified the CD-ROM drive on the command line, but it
  252.           wasn't a CD-ROM after all.. Please check your typing.
  253.      5    Your CD-ROM disk drive is empty. Please insert the InfoMagic
  254.           CD-ROM disk.
  255.      6    You don't any CD disks in any online CD-ROM disk drive, or at
  256.           least InterCD could not find them. Please recheck your system.
  257.      7    Graphics library initialization failed (gxInit).
  258.      8    Graphics library initialization for 640x480x16 mode failed.
  259.      9    Display mode setting failed. You need standard VGA compatible
  260.           display card and monitor.
  261.     18    Graphics library initialization for 640x480x16 mode failed after
  262.           returning from Shell escape.
  263.     19    Display mode setting failed after returning from Shell escape.
  264.           You need standard VGA compatible display card and monitor.
  265.  
  266. ** DEVELOPMENT
  267.  
  268.      InterCD was written with the following material:
  269.  
  270.      Turbo C++ 3.0 compiler.
  271.      MicroEMACS 3.11c editor.
  272.  
  273.      Genus GX Kernel 3.03 graphics library.
  274.      Genus GX Graphics 3.01 graphics library.
  275.      Genus PCX Toolkit 6.01 graphics library.
  276.      SPAWNO 4.13 by Ralf Brown disk/EMS/XMS/INT15 swapping library.
  277.  
  278.      Countless sleepless nights during spring 1995.
  279.      Loads of Fazer Milk Chokolate with whole hazelnuts.
  280.      Music of Bo Diddley, Muddy Water, John Lee Hooker, Howlin' Wolf et al.
  281.  
  282. ** HISTORY
  283.  
  284.      1.00q
  285.           The final approved and first released version.
  286.  
  287. ** BUGS
  288.  
  289.      No known bugs. If you find one, please contact the author right
  290.      away and describe what you suspect to be a bug.
  291.  
  292. ** AUTHOR
  293.  
  294.      Mr. Jouni Miettunen
  295.      Rautatienkatu 20 A 10
  296.      FIN-90100 OULU
  297.      FINLAND - EUROPE
  298.  
  299.      email: jon@x2ftp.oulu.fi
  300.             jon@stekt.oulu.fi
  301.  
  302. ** SEE ALSO
  303.  
  304.      ftp://x2ftp.oulu.fi
  305.      http://www.infomagic.com
  306.      news:rec.games.programming
  307.  
  308. ** STATUS
  309.  
  310.      Copyright (C) 1995 by Jouni Miettunen. All Rights Reserved.
  311.  
  312.      This program is furnished under a license agreement with InfoMagic,
  313.      and may be used or copied only in accordance with the terms of that
  314.      agreement. All other use is prohibited without the express written
  315.      permission of the copyright holder.
  316.  
  317.      All brand and product names are trademarks or registered trademarks
  318.      of their respective holders.
  319.  
  320. INTERCD(1)                USER COMMANDS                   INTERCD(1)
  321. Jouni Miettunen * jon@stekt.oulu.fi * Oulu * Finland * Europe * 1995
  322.